home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3c / mq_send.z / mq_send
Encoding:
Text File  |  2002-10-03  |  5.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. mmmmqqqq____sssseeeennnndddd((((3333cccc))))                                                        mmmmqqqq____sssseeeennnndddd((((3333cccc))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _mmmm_qqqq______ssss_eeee_nnnn_dddd - send a message to a queue
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_mmmm_qqqq_uuuu_eeee_uuuu_eeee_...._hhhh_>>>>
  13.  
  14.      _iiii_nnnn_tttt _mmmm_qqqq______ssss_eeee_nnnn_dddd _((((_mmmm_qqqq_dddd______tttt _m_q_d_,,,, _cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_m_s_g_p_t_r_,,,, _ssss_iiii_zzzz_eeee______tttt _m_s_g_l_e_n_,,,, _uuuu_nnnn_ssss_iiii_gggg_nnnn_eeee_dddd _iiii_nnnn_tttt
  15.      _m_s_g__p_r_i_o_))))_;;;;
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      _mmmm_qqqq______ssss_eeee_nnnn_dddd sends the message at address _m_s_g_p_t_r, of size _m_s_g_l_e_n bytes, to the
  19.      message queue named by _m_q_d.
  20.  
  21.      The message is queued in priority order, as specified by _m_s_g_p_r_i_o.  The
  22.      larger the numerical value of the priority, the more important the
  23.      message. Messages with same priorities are queued in FIFO order.  The
  24.      value of _m_s_g_p_r_i_o must be less than {_MMMM_QQQQ______PPPP_RRRR_IIII_OOOO______MMMM_AAAA_XXXX}.
  25.  
  26.      A message queue is full when the number of the messages queued equals the
  27.      value the of _m_q__m_a_x_m_s_g attribute of the queue. If the OOOO____NNNNOOOONNNNBBBBLLLLOOOOCCCCKKKK flag is
  28.      set for the message queue descriptor _m_q_d, _mmmm_qqqq______ssss_eeee_nnnn_dddd will not block when the
  29.      queue is full [see _mmmm_qqqq______ssss_eeee_tttt_aaaa_tttt_tttt_rrrr(3c)].  Otherwise, _mmmm_qqqq______ssss_eeee_nnnn_dddd will block until
  30.      either space becomes available to queue the message, or _mmmm_qqqq______ssss_eeee_nnnn_dddd is
  31.      interrupted by a signal.
  32.  
  33.      If multiple processes are waiting to send a message to the queue, the
  34.      highest priority process will be unblocked to queue its message when
  35.      space becomes available. Processes with equal priorities, blocked waiting
  36.      to queue a message, are unblocked in FIFO order when queue space becomes
  37.      available.
  38.  
  39.      _mmmm_qqqq______ssss_eeee_nnnn_dddd will fail if one or more of the following conditions are true:
  40.  
  41.      [EAGAIN]       The _OOOO______NNNN_OOOO_NNNN_BBBB_LLLL_OOOO_CCCC_KKKK flag is set for the queue descriptor and
  42.                     the queue is full.
  43.  
  44.      [EBADF]        The message queue descriptor, _m_q_d, is not valid or the
  45.                     queue was not opened for writing.
  46.  
  47.      [EINTR]        The _mmmm_qqqq______ssss_eeee_nnnn_dddd system call was interrupted by a signal.
  48.  
  49.      [EINVAL]       The value of _m_s_g_p_r_i_o is not less than {_MMMM_QQQQ______PPPP_RRRR_IIII_OOOO______MMMM_AAAA_XXXX}.
  50.  
  51.      [EMSGSIZE]     The size of the message, _m_s_g_l_e_n, is greater than the value
  52.                     of the _m_q__m_a_x_s_i_z_e attribute of the queue.
  53.  
  54. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  55.      _mmmm_qqqq______oooo_pppp_eeee_nnnn(3c), _iiii_nnnn_tttt_rrrr_oooo(3c), _mmmm_qqqq______uuuu_nnnn_llll_iiii_nnnn_kkkk(3c), _mmmm_qqqq______rrrr_eeee_cccc_eeee_iiii_vvvv_eeee(3c), _mmmm_qqqq______gggg_eeee_tttt_aaaa_tttt_tttt_rrrr(3c),
  56.      _mmmm_qqqq______nnnn_oooo_tttt_iiii_ffff_yyyy(3c),
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. mmmmqqqq____sssseeeennnndddd((((3333cccc))))                                                        mmmmqqqq____sssseeeennnndddd((((3333cccc))))
  71.  
  72.  
  73.  
  74. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  75.      Upon successful completion, a value of 0 is returned and the message is
  76.      added to the queue.  Otherwise, the message is not added to the queue, a
  77.      value of -1 is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to indicate the error.
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.